How do you link documents together in a JSON web service?

You can make up your own scheme by simply having some fields pointing to URLs like so:

{

    "name": "Fred",

    "self": "http://example.com/fred"

}

 

Or you could adopt something like Atom and JSONify it:

{ "name": "Fred", "link": { "href": "http://example.com/fred", "rel": "self" } }

This latter approach has been taken a step further by Mike Kelly with his Hypertext Application Language (HAL). http://stateless.co/hal_specification.html